<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>detect_edge_segments [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_segmentation.html">分割</a> / <a href="toc_segmentation_edges.html">Edges</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">detect_edge_segments</span><span data-if="c" style="display:none;">T_detect_edge_segments</span><span data-if="cpp" style="display:none;">DetectEdgeSegments</span><span data-if="dotnet" style="display:none;">DetectEdgeSegments</span><span data-if="python" style="display:none;">detect_edge_segments</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">detect_edge_segments</span><span data-if="c" style="display:none;">T_detect_edge_segments</span><span data-if="cpp" style="display:none;">DetectEdgeSegments</span><span data-if="dotnet" style="display:none;">DetectEdgeSegments</span><span data-if="python" style="display:none;">detect_edge_segments</span></code> — Detect straight edge segments.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>detect_edge_segments</b>(<a href="#Image"><i>Image</i></a> :  : <a href="#SobelSize"><i>SobelSize</i></a>, <a href="#MinAmplitude"><i>MinAmplitude</i></a>, <a href="#MaxDistance"><i>MaxDistance</i></a>, <a href="#MinLength"><i>MinLength</i></a> : <a href="#BeginRow"><i>BeginRow</i></a>, <a href="#BeginCol"><i>BeginCol</i></a>, <a href="#EndRow"><i>EndRow</i></a>, <a href="#EndCol"><i>EndCol</i></a>)</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_detect_edge_segments</b>(const Hobject <a href="#Image"><i>Image</i></a>, const Htuple <a href="#SobelSize"><i>SobelSize</i></a>, const Htuple <a href="#MinAmplitude"><i>MinAmplitude</i></a>, const Htuple <a href="#MaxDistance"><i>MaxDistance</i></a>, const Htuple <a href="#MinLength"><i>MinLength</i></a>, Htuple* <a href="#BeginRow"><i>BeginRow</i></a>, Htuple* <a href="#BeginCol"><i>BeginCol</i></a>, Htuple* <a href="#EndRow"><i>EndRow</i></a>, Htuple* <a href="#EndCol"><i>EndCol</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>DetectEdgeSegments</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, const HTuple&amp; <a href="#SobelSize"><i>SobelSize</i></a>, const HTuple&amp; <a href="#MinAmplitude"><i>MinAmplitude</i></a>, const HTuple&amp; <a href="#MaxDistance"><i>MaxDistance</i></a>, const HTuple&amp; <a href="#MinLength"><i>MinLength</i></a>, HTuple* <a href="#BeginRow"><i>BeginRow</i></a>, HTuple* <a href="#BeginCol"><i>BeginCol</i></a>, HTuple* <a href="#EndRow"><i>EndRow</i></a>, HTuple* <a href="#EndCol"><i>EndCol</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>DetectEdgeSegments</b>(Hlong <a href="#SobelSize"><i>SobelSize</i></a>, Hlong <a href="#MinAmplitude"><i>MinAmplitude</i></a>, Hlong <a href="#MaxDistance"><i>MaxDistance</i></a>, Hlong <a href="#MinLength"><i>MinLength</i></a>, HTuple* <a href="#BeginRow"><i>BeginRow</i></a>, HTuple* <a href="#BeginCol"><i>BeginCol</i></a>, HTuple* <a href="#EndRow"><i>EndRow</i></a>, HTuple* <a href="#EndCol"><i>EndCol</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>DetectEdgeSegments</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, <a href="HTuple.html">HTuple</a> <a href="#SobelSize"><i>sobelSize</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MinAmplitude"><i>minAmplitude</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaxDistance"><i>maxDistance</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MinLength"><i>minLength</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#BeginRow"><i>beginRow</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#BeginCol"><i>beginCol</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#EndRow"><i>endRow</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#EndCol"><i>endCol</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>.<b>DetectEdgeSegments</b>(int <a href="#SobelSize"><i>sobelSize</i></a>, int <a href="#MinAmplitude"><i>minAmplitude</i></a>, int <a href="#MaxDistance"><i>maxDistance</i></a>, int <a href="#MinLength"><i>minLength</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#BeginRow"><i>beginRow</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#BeginCol"><i>beginCol</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#EndRow"><i>endRow</i></a>, out <a href="HTuple.html">HTuple</a> <a href="#EndCol"><i>endCol</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>detect_edge_segments</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#SobelSize"><i>sobel_size</i></a>: int, <a href="#MinAmplitude"><i>min_amplitude</i></a>: int, <a href="#MaxDistance"><i>max_distance</i></a>: int, <a href="#MinLength"><i>min_length</i></a>: int) -&gt; Tuple[Sequence[int], Sequence[int], Sequence[int], Sequence[int]]</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">detect_edge_segments</span><span data-if="c" style="display:none">detect_edge_segments</span><span data-if="cpp" style="display:none">DetectEdgeSegments</span><span data-if="com" style="display:none">DetectEdgeSegments</span><span data-if="dotnet" style="display:none">DetectEdgeSegments</span><span data-if="python" style="display:none">detect_edge_segments</span></code> detects straight edge segments in the gray
image <a href="#Image"><i><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></i></a>.  The extracted edge segments are returned as
line segments with start point (<a href="#BeginRow"><i><code><span data-if="hdevelop" style="display:inline">BeginRow</span><span data-if="c" style="display:none">BeginRow</span><span data-if="cpp" style="display:none">BeginRow</span><span data-if="com" style="display:none">BeginRow</span><span data-if="dotnet" style="display:none">beginRow</span><span data-if="python" style="display:none">begin_row</span></code></i></a>,<a href="#BeginCol"><i><code><span data-if="hdevelop" style="display:inline">BeginCol</span><span data-if="c" style="display:none">BeginCol</span><span data-if="cpp" style="display:none">BeginCol</span><span data-if="com" style="display:none">BeginCol</span><span data-if="dotnet" style="display:none">beginCol</span><span data-if="python" style="display:none">begin_col</span></code></i></a>)
and end point (<a href="#EndRow"><i><code><span data-if="hdevelop" style="display:inline">EndRow</span><span data-if="c" style="display:none">EndRow</span><span data-if="cpp" style="display:none">EndRow</span><span data-if="com" style="display:none">EndRow</span><span data-if="dotnet" style="display:none">endRow</span><span data-if="python" style="display:none">end_row</span></code></i></a>,<a href="#EndCol"><i><code><span data-if="hdevelop" style="display:inline">EndCol</span><span data-if="c" style="display:none">EndCol</span><span data-if="cpp" style="display:none">EndCol</span><span data-if="com" style="display:none">EndCol</span><span data-if="dotnet" style="display:none">endCol</span><span data-if="python" style="display:none">end_col</span></code></i></a>).  Edge detection
is based on the Sobel filter, using <i><span data-if="hdevelop" style="display:inline">'sum_abs'</span><span data-if="c" style="display:none">"sum_abs"</span><span data-if="cpp" style="display:none">"sum_abs"</span><span data-if="com" style="display:none">"sum_abs"</span><span data-if="dotnet" style="display:none">"sum_abs"</span><span data-if="python" style="display:none">"sum_abs"</span></i> as parameter and
<a href="#SobelSize"><i><code><span data-if="hdevelop" style="display:inline">SobelSize</span><span data-if="c" style="display:none">SobelSize</span><span data-if="cpp" style="display:none">SobelSize</span><span data-if="com" style="display:none">SobelSize</span><span data-if="dotnet" style="display:none">sobelSize</span><span data-if="python" style="display:none">sobel_size</span></code></i></a> as the filter mask size (see
<a href="sobel_amp.html"><code><span data-if="hdevelop" style="display:inline">sobel_amp</span><span data-if="c" style="display:none">sobel_amp</span><span data-if="cpp" style="display:none">SobelAmp</span><span data-if="com" style="display:none">SobelAmp</span><span data-if="dotnet" style="display:none">SobelAmp</span><span data-if="python" style="display:none">sobel_amp</span></code></a>).  Only pixels with a filter response larger
than <a href="#MinAmplitude"><i><code><span data-if="hdevelop" style="display:inline">MinAmplitude</span><span data-if="c" style="display:none">MinAmplitude</span><span data-if="cpp" style="display:none">MinAmplitude</span><span data-if="com" style="display:none">MinAmplitude</span><span data-if="dotnet" style="display:none">minAmplitude</span><span data-if="python" style="display:none">min_amplitude</span></code></i></a> are used as candidates for edge points.
These thresholded edge points are thinned and split into straight
segments.  Due to technical reasons, edge points in which several
edges meet are lost.  Therefore, <code><span data-if="hdevelop" style="display:inline">detect_edge_segments</span><span data-if="c" style="display:none">detect_edge_segments</span><span data-if="cpp" style="display:none">DetectEdgeSegments</span><span data-if="com" style="display:none">DetectEdgeSegments</span><span data-if="dotnet" style="display:none">DetectEdgeSegments</span><span data-if="python" style="display:none">detect_edge_segments</span></code> usually
does not return closed object contours.  The parameter
<a href="#MaxDistance"><i><code><span data-if="hdevelop" style="display:inline">MaxDistance</span><span data-if="c" style="display:none">MaxDistance</span><span data-if="cpp" style="display:none">MaxDistance</span><span data-if="com" style="display:none">MaxDistance</span><span data-if="dotnet" style="display:none">maxDistance</span><span data-if="python" style="display:none">max_distance</span></code></i></a> controls the maximum allowed distance of an
edge point to its approximating line.  For efficiency reasons, the
sum of the absolute values of the coordinate differences is used
instead of the Euclidean distance.  <a href="#MinLength"><i><code><span data-if="hdevelop" style="display:inline">MinLength</span><span data-if="c" style="display:none">MinLength</span><span data-if="cpp" style="display:none">MinLength</span><span data-if="com" style="display:none">MinLength</span><span data-if="dotnet" style="display:none">minLength</span><span data-if="python" style="display:none">min_length</span></code></i></a> controls
the minimum length of the line segments.  Lines shorter than
<a href="#MinLength"><i><code><span data-if="hdevelop" style="display:inline">MinLength</span><span data-if="c" style="display:none">MinLength</span><span data-if="cpp" style="display:none">MinLength</span><span data-if="com" style="display:none">MinLength</span><span data-if="dotnet" style="display:none">minLength</span><span data-if="python" style="display:none">min_length</span></code></i></a> are not returned.</p>
<h2 id="sec_attention">注意</h2>
<p>Note that filter operators may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter <a href="toc_filters.html">过滤器</a>.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Input image.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="SobelSize" class="parname"><b><code><span data-if="hdevelop" style="display:inline">SobelSize</span><span data-if="c" style="display:none">SobelSize</span><span data-if="cpp" style="display:none">SobelSize</span><span data-if="com" style="display:none">SobelSize</span><span data-if="dotnet" style="display:none">sobelSize</span><span data-if="python" style="display:none">sobel_size</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Mask size of the Sobel operator.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>5</p>
<p class="pardesc"><span class="parcat">List of values:
      </span>3, 5, 7, 9, 11, 13</p>
</div>
  <div class="par">
<div class="parhead">
<span id="MinAmplitude" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MinAmplitude</span><span data-if="c" style="display:none">MinAmplitude</span><span data-if="cpp" style="display:none">MinAmplitude</span><span data-if="com" style="display:none">MinAmplitude</span><span data-if="dotnet" style="display:none">minAmplitude</span><span data-if="python" style="display:none">min_amplitude</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Minimum edge strength.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>32</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 80, 90, 100, 110</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">MinAmplitude</span>
    <span data-if="c" style="display:none">MinAmplitude</span>
    <span data-if="cpp" style="display:none">MinAmplitude</span>
    <span data-if="com" style="display:none">MinAmplitude</span>
    <span data-if="dotnet" style="display:none">minAmplitude</span>
    <span data-if="python" style="display:none">min_amplitude</span>
    
          ≤
          255</code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="MaxDistance" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MaxDistance</span><span data-if="c" style="display:none">MaxDistance</span><span data-if="cpp" style="display:none">MaxDistance</span><span data-if="com" style="display:none">MaxDistance</span><span data-if="dotnet" style="display:none">maxDistance</span><span data-if="python" style="display:none">max_distance</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Maximum distance of the approximating line to
its original edge.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>3</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>2, 3, 4, 5, 6, 7, 8</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">MaxDistance</span>
    <span data-if="c" style="display:none">MaxDistance</span>
    <span data-if="cpp" style="display:none">MaxDistance</span>
    <span data-if="com" style="display:none">MaxDistance</span>
    <span data-if="dotnet" style="display:none">maxDistance</span>
    <span data-if="python" style="display:none">max_distance</span>
    </code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="MinLength" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MinLength</span><span data-if="c" style="display:none">MinLength</span><span data-if="cpp" style="display:none">MinLength</span><span data-if="com" style="display:none">MinLength</span><span data-if="dotnet" style="display:none">minLength</span><span data-if="python" style="display:none">min_length</span></code></b> (input_control)  </span><span>integer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Minimum length of to resulting line segments.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>10</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>3, 5, 7, 9, 11, 13, 16, 20</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">MinLength</span>
    <span data-if="c" style="display:none">MinLength</span>
    <span data-if="cpp" style="display:none">MinLength</span>
    <span data-if="com" style="display:none">MinLength</span>
    <span data-if="dotnet" style="display:none">minLength</span>
    <span data-if="python" style="display:none">min_length</span>
    </code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>1</p>
</div>
  <div class="par">
<div class="parhead">
<span id="BeginRow" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BeginRow</span><span data-if="c" style="display:none">BeginRow</span><span data-if="cpp" style="display:none">BeginRow</span><span data-if="com" style="display:none">BeginRow</span><span data-if="dotnet" style="display:none">beginRow</span><span data-if="python" style="display:none">begin_row</span></code></b> (output_control)  </span><span>line.begin.y-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Row coordinate of the line segments' start points.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="BeginCol" class="parname"><b><code><span data-if="hdevelop" style="display:inline">BeginCol</span><span data-if="c" style="display:none">BeginCol</span><span data-if="cpp" style="display:none">BeginCol</span><span data-if="com" style="display:none">BeginCol</span><span data-if="dotnet" style="display:none">beginCol</span><span data-if="python" style="display:none">begin_col</span></code></b> (output_control)  </span><span>line.begin.x-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Column coordinate of the line segments' start points.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="EndRow" class="parname"><b><code><span data-if="hdevelop" style="display:inline">EndRow</span><span data-if="c" style="display:none">EndRow</span><span data-if="cpp" style="display:none">EndRow</span><span data-if="com" style="display:none">EndRow</span><span data-if="dotnet" style="display:none">endRow</span><span data-if="python" style="display:none">end_row</span></code></b> (output_control)  </span><span>line.end.y-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Row coordinate of the line segments' end points.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="EndCol" class="parname"><b><code><span data-if="hdevelop" style="display:inline">EndCol</span><span data-if="c" style="display:none">EndCol</span><span data-if="cpp" style="display:none">EndCol</span><span data-if="com" style="display:none">EndCol</span><span data-if="dotnet" style="display:none">endCol</span><span data-if="python" style="display:none">end_col</span></code></b> (output_control)  </span><span>line.end.x-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Column coordinate of the line segments' end points.</p>
</div>
<h2 id="sec_example_all">例程 (C)</h2>
<pre class="example">
Htuple  SobelSize,MinAmplitude,MaxDistance,MinLength;
Htuple  RowBegin,ColBegin,RowEnd,ColEnd;

create_tuple(&amp;SobelSize,1);
set_i(SobelSize,5,0);
create_tuple(&amp;MinAmplitude,1);
set_i(MinAmplitude,32,0);
create_tuple(&amp;MaxDistance,1);
set_i(MaxDistance,3,0);
create_tuple(&amp;MinLength,1);
set_i(MinLength,10,0);
T_detect_edge_segments(Image,SobelSize,MinAmplitude,MaxDistance,MinLength,
                &amp;RowBegin,&amp;ColBegin,&amp;RowEnd,&amp;ColEnd);
</pre>
<h2 id="sec_result">结果</h2>
<p><code><span data-if="hdevelop" style="display:inline">detect_edge_segments</span><span data-if="c" style="display:none">detect_edge_segments</span><span data-if="cpp" style="display:none">DetectEdgeSegments</span><span data-if="com" style="display:none">DetectEdgeSegments</span><span data-if="dotnet" style="display:none">DetectEdgeSegments</span><span data-if="python" style="display:none">detect_edge_segments</span></code> returns <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
     if all parameters are
correct.  If the input is empty the behavior can be set via
<a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system('no_object_result',&lt;Result&gt;)</span><span data-if="c" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span><span data-if="cpp" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="com" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("no_object_result",&lt;Result&gt;)</span><span data-if="python" style="display:none">set_system("no_object_result",&lt;Result&gt;)</span></code></a>.  If
necessary, an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="sigma_image.html"><span data-if="hdevelop" style="display:inline">sigma_image</span><span data-if="c" style="display:none">sigma_image</span><span data-if="cpp" style="display:none">SigmaImage</span><span data-if="com" style="display:none">SigmaImage</span><span data-if="dotnet" style="display:none">SigmaImage</span><span data-if="python" style="display:none">sigma_image</span></a></code>, 
<code><a href="median_image.html"><span data-if="hdevelop" style="display:inline">median_image</span><span data-if="c" style="display:none">median_image</span><span data-if="cpp" style="display:none">MedianImage</span><span data-if="com" style="display:none">MedianImage</span><span data-if="dotnet" style="display:none">MedianImage</span><span data-if="python" style="display:none">median_image</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="partition_lines.html"><span data-if="hdevelop" style="display:inline">partition_lines</span><span data-if="c" style="display:none">partition_lines</span><span data-if="cpp" style="display:none">PartitionLines</span><span data-if="com" style="display:none">PartitionLines</span><span data-if="dotnet" style="display:none">PartitionLines</span><span data-if="python" style="display:none">partition_lines</span></a></code>, 
<code><a href="line_position.html"><span data-if="hdevelop" style="display:inline">line_position</span><span data-if="c" style="display:none">line_position</span><span data-if="cpp" style="display:none">LinePosition</span><span data-if="com" style="display:none">LinePosition</span><span data-if="dotnet" style="display:none">LinePosition</span><span data-if="python" style="display:none">line_position</span></a></code>, 
<code><a href="line_orientation.html"><span data-if="hdevelop" style="display:inline">line_orientation</span><span data-if="c" style="display:none">line_orientation</span><span data-if="cpp" style="display:none">LineOrientation</span><span data-if="com" style="display:none">LineOrientation</span><span data-if="dotnet" style="display:none">LineOrientation</span><span data-if="python" style="display:none">line_orientation</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="sobel_amp.html"><span data-if="hdevelop" style="display:inline">sobel_amp</span><span data-if="c" style="display:none">sobel_amp</span><span data-if="cpp" style="display:none">SobelAmp</span><span data-if="com" style="display:none">SobelAmp</span><span data-if="dotnet" style="display:none">SobelAmp</span><span data-if="python" style="display:none">sobel_amp</span></a></code>, 
<code><a href="threshold.html"><span data-if="hdevelop" style="display:inline">threshold</span><span data-if="c" style="display:none">threshold</span><span data-if="cpp" style="display:none">Threshold</span><span data-if="com" style="display:none">Threshold</span><span data-if="dotnet" style="display:none">Threshold</span><span data-if="python" style="display:none">threshold</span></a></code>, 
<code><a href="skeleton.html"><span data-if="hdevelop" style="display:inline">skeleton</span><span data-if="c" style="display:none">skeleton</span><span data-if="cpp" style="display:none">Skeleton</span><span data-if="com" style="display:none">Skeleton</span><span data-if="dotnet" style="display:none">Skeleton</span><span data-if="python" style="display:none">skeleton</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
